home *** CD-ROM | disk | FTP | other *** search
/ Danny Amor's Online Library / Danny Amor's Online Library - Volume 1.iso / html / rfc / rfcxxxx / rfc1514 < prev    next >
Text File  |  1995-07-25  |  64KB  |  1,852 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7. Network Working Group                                          P. Grillo
  8. Request for Comments: 1514                           Network Innovations
  9.                                                        Intel Corporation
  10.                                                            S. Waldbusser
  11.                                               Carnegie Mellon University
  12.                                                           September 1993
  13.  
  14.  
  15.                            Host Resources MIB
  16.  
  17. Status of this Memo
  18.  
  19.    This RFC specifies an Internet standards track protocol for the
  20.    Internet community, and requests discussion and suggestions for
  21.    improvements.  Please refer to the current edition of the "Internet
  22.    Official Protocol Standards" for the standardization state and status
  23.    of this protocol.  Distribution of this memo is unlimited.
  24.  
  25. Abstract
  26.  
  27.    This memo defines a MIB for use with managing host systems.  The term
  28.    "host" is construed to mean any computer that communicates with other
  29.    similar computers attached to the internet and that is directly used
  30.    by one or more human beings. Although this MIB does not necessarily
  31.    apply to devices whose primary function is communications services
  32.    (e.g., terminal servers, routers, bridges, monitoring equipment),
  33.    such relevance is not explicitly precluded.  This MIB instruments
  34.    attributes common to all internet hosts including, for example, both
  35.    personal computers and systems that run variants of Unix.
  36.  
  37. Table of Contents
  38.  
  39.    1. The Network Management Framework ......................    2
  40.    2. Host Resources MIB ....................................    3
  41.    3. Definitions ...........................................    3
  42.    4.1 Textual Conventions ..................................    3
  43.    4.2 The Host Resources System Group ......................    5
  44.    4.3 The Host Resources Storage Group .....................    6
  45.    4.4 The Host Resources Device Group ......................   10
  46.    4.5 The Host Resources Running Software Group ............   25
  47.    4.6 The Host Resources  Running  Software  Performance
  48.        Group ................................................   27
  49.    4.7 The Host Resources Installed Software Group ..........   29
  50.    5. References ............................................   31
  51.    6. Acknowledgments .......................................   32
  52.    7. Security Considerations ...............................   32
  53.    8. Authors' Addresses ....................................   33
  54.  
  55.  
  56.  
  57.  
  58. Grillo & Waldbusser                                             [Page 1]
  59.  
  60. RFC 1514                   Host Resources MIB             September 1993
  61.  
  62.  
  63. 1.  The Network Management Framework
  64.  
  65.    The Internet-standard Network Management Framework consists of three
  66.    components.  They are:
  67.  
  68.       STD 16, RFC 1155 [1] which defines the SMI, the mechanisms used
  69.       for describing and naming objects for the purpose of management.
  70.       STD 16, RFC 1212 [2] defines a more concise description mechanism,
  71.       which is wholly consistent with the SMI.
  72.  
  73.       STD 17, RFC 1213 [3] which defines MIB-II, the core set of managed
  74.       objects for the Internet suite of protocols.
  75.  
  76.       STD 15, RFC 1157 [4] which defines the SNMP, the protocol used for
  77.       network access to managed objects.
  78.  
  79.    The Framework permits new objects to be defined for the purpose of
  80.    experimentation and evaluation.
  81.  
  82.    Managed objects are accessed via a virtual information store, termed
  83.    the Management Information Base or MIB.  Within a given MIB module,
  84.    objects are defined using STD 16, RFC 1212's OBJECT-TYPE macro.  At a
  85.    minimum, each object has a name, a syntax, an access-level, and an
  86.    implementation-status.
  87.  
  88.    The name is an object identifier, an administratively assigned name,
  89.    which specifies an object type.  The object type together with an
  90.    object instance serves to uniquely identify a specific instantiation
  91.    of the object.  For human convenience, we often use a textual string,
  92.    termed the object descriptor, to also refer to the object type.
  93.  
  94.    The syntax of an object type defines the abstract data structure
  95.    corresponding to that object type.  The ASN.1[5] language is used for
  96.    this purpose.  However, RFC 1155 purposely restricts the ASN.1
  97.    constructs which may be used.  These restrictions are explicitly made
  98.    for simplicity.
  99.  
  100.    The access-level of an object type defines whether it makes "protocol
  101.    sense" to read and/or write the value of an instance of the object
  102.    type.  (This access-level is independent of any administrative
  103.    authorization policy.)
  104.  
  105.    The implementation-status of an object type indicates whether the
  106.    object is mandatory, optional, obsolete, or deprecated.
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114. Grillo & Waldbusser                                             [Page 2]
  115.  
  116. RFC 1514                   Host Resources MIB             September 1993
  117.  
  118.  
  119. 2.  Host Resources MIB
  120.  
  121.    The Host Resources MIB defines a uniform set of objects useful for
  122.    the management of host computers.  Host computers  are independent of
  123.    the operating system, network services, or any software application.
  124.  
  125.    The Host Resources MIB defines objects which are common across many
  126.    computer system architectures.
  127.  
  128.    In addition, there are objects in MIB-II [3] which also provide host
  129.    management functionality. Implementation of the System and Interfaces
  130.    groups is mandatory for implementors of the Host Resources MIB.
  131.  
  132. 3.  Definitions
  133.  
  134.    HOST-RESOURCES-MIB DEFINITIONS ::= BEGIN
  135.  
  136.    IMPORTS
  137.        OBJECT-TYPE               FROM RFC-1212
  138.        DisplayString             FROM RFC1213-MIB
  139.        TimeTicks,
  140.        Counter, Gauge            FROM RFC1155-SMI;
  141.  
  142.    host     OBJECT IDENTIFIER ::= { mib-2 25 }
  143.  
  144.  
  145.    hrSystem        OBJECT IDENTIFIER ::= { host 1 }
  146.    hrStorage       OBJECT IDENTIFIER ::= { host 2 }
  147.    hrDevice        OBJECT IDENTIFIER ::= { host 3 }
  148.    hrSWRun         OBJECT IDENTIFIER ::= { host 4 }
  149.    hrSWRunPerf     OBJECT IDENTIFIER ::= { host 5 }
  150.    hrSWInstalled   OBJECT IDENTIFIER ::= { host 6 }
  151.  
  152.  
  153.    -- textual conventions
  154.  
  155.    -- a truth value
  156.    Boolean ::=   INTEGER { true(1), false(2) }
  157.  
  158.  
  159.    -- memory size, expressed in units of 1024bytes
  160.    KBytes ::=    INTEGER (0..2147483647)
  161.  
  162.    -- This textual convention is intended to identify the manufacturer,
  163.    -- model, and version of a specific hardware or software product.
  164.    -- It is suggested that these OBJECT IDENTIFIERs are allocated such
  165.    -- that all products from a particular manufacturer are registered
  166.    -- under a subtree distinct to that manufacturer.  In addition, all
  167.  
  168.  
  169.  
  170. Grillo & Waldbusser                                             [Page 3]
  171.  
  172. RFC 1514                   Host Resources MIB             September 1993
  173.  
  174.  
  175.    -- versions of a product should be registered under a subtree
  176.    -- distinct to that product.  With this strategy, a management
  177.    -- station may uniquely determine the manufacturer and/or model of a
  178.    -- product whose productID is unknown to the management station.
  179.    -- Objects of this type may be useful for inventory purposes or for
  180.    -- automatically detecting incompatibilities or version mismatches
  181.    -- between various hardware and software components on a system.
  182.    ProductID ::= OBJECT IDENTIFIER
  183.    -- unknownProduct will be used for any unknown ProductID
  184.    -- unknownProduct OBJECT IDENTIFIER ::= { 0 0 }
  185.  
  186.    -- For example, the product ID for the ACME 4860 66MHz clock doubled
  187.    -- processor might be:
  188.    -- enterprises.acme.acmeProcessors.a4860DX2.MHz66
  189.    -- A software product might be registered as:
  190.    -- enterprises.acme.acmeOperatingSystems.acmeDOS.six(6).one(1)
  191.  
  192.  
  193.    DateAndTime ::= OCTET STRING (SIZE (8 | 11))
  194.    --        A date-time specification for the local time of day.
  195.    --        This data type is intended to provide a consistent
  196.    --        method of reporting date information.
  197.    --
  198.    --            field  octets  contents                  range
  199.    --            _____  ______  ________                  _____
  200.    --              1      1-2   year                      0..65536
  201.    --                           (in network byte order)
  202.    --              2       3    month                     1..12
  203.    --              3       4    day                       1..31
  204.    --              4       5    hour                      0..23
  205.    --              5       6    minutes                   0..59
  206.    --              6       7    seconds                   0..60
  207.    --                           (use 60 for leap-second)
  208.    --              7       8    deci-seconds              0..9
  209.    --              8       9    direction from UTC        "+" / "-"
  210.    --                           (in ascii notation)
  211.    --              9      10    hours from UTC            0..11
  212.    --             10      11    minutes from UTC          0..59
  213.    --
  214.    --            Note that if only local time is known, then
  215.    --            timezone information (fields 8-10) is not present.
  216.  
  217.    InternationalDisplayString ::= OCTET STRING
  218.    --  This data type is used to model textual information in some
  219.    --  character set.  A network management station should use a local
  220.    --  algorithm to determine which character set is in use and how it
  221.    --  should be displayed.  Note that this character set may be encoded
  222.    --  with more than one octet per symbol, but will most often be NVT
  223.  
  224.  
  225.  
  226. Grillo & Waldbusser                                             [Page 4]
  227.  
  228. RFC 1514                   Host Resources MIB             September 1993
  229.  
  230.  
  231.    --  ASCII.
  232.  
  233.  
  234.    -- The Host Resources System Group
  235.    --
  236.    -- Implementation of this group is mandatory for all host systems.
  237.    hrSystemUptime OBJECT-TYPE
  238.        SYNTAX TimeTicks
  239.        ACCESS read-only
  240.        STATUS mandatory
  241.        DESCRIPTION
  242.               "The amount of time since this host was last
  243.               initialized.  Note that this is different from
  244.               sysUpTime in MIB-II [3] because sysUpTime is the
  245.               uptime of the network management portion of the
  246.               system."
  247.        ::= { hrSystem 1 }
  248.  
  249.    hrSystemDate OBJECT-TYPE
  250.        SYNTAX DateAndTime
  251.        ACCESS read-write
  252.        STATUS mandatory
  253.        DESCRIPTION
  254.               "The host's notion of the local date and time of
  255.               day."
  256.        ::= { hrSystem 2 }
  257.  
  258.    hrSystemInitialLoadDevice OBJECT-TYPE
  259.        SYNTAX INTEGER (1..2147483647)
  260.        ACCESS read-write
  261.        STATUS mandatory
  262.        DESCRIPTION
  263.               "The index of the hrDeviceEntry for the device from
  264.               which this host is configured to load its initial
  265.               operating system configuration."
  266.        ::= { hrSystem 3 }
  267.  
  268.    hrSystemInitialLoadParameters OBJECT-TYPE
  269.        SYNTAX InternationalDisplayString (SIZE (0..128))
  270.        ACCESS read-write
  271.        STATUS mandatory
  272.        DESCRIPTION
  273.               "This object contains the parameters (e.g. a
  274.               pathname and parameter) supplied to the load device
  275.               when requesting the initial operating system
  276.               configuration from that device."
  277.        ::= { hrSystem 4 }
  278.  
  279.  
  280.  
  281.  
  282. Grillo & Waldbusser                                             [Page 5]
  283.  
  284. RFC 1514                   Host Resources MIB             September 1993
  285.  
  286.  
  287.    hrSystemNumUsers OBJECT-TYPE
  288.        SYNTAX Gauge
  289.        ACCESS read-only
  290.        STATUS mandatory
  291.        DESCRIPTION
  292.               "The number of user sessions for which this host is
  293.               storing state information.  A session is a
  294.               collection of processes requiring a single act of
  295.               user authentication and possibly subject to
  296.               collective job control."
  297.        ::= { hrSystem 5 }
  298.  
  299.    hrSystemProcesses OBJECT-TYPE
  300.        SYNTAX Gauge
  301.        ACCESS read-only
  302.        STATUS mandatory
  303.        DESCRIPTION
  304.               "The number of process contexts currently loaded or
  305.               running on this system."
  306.        ::= { hrSystem 6 }
  307.  
  308.    hrSystemMaxProcesses OBJECT-TYPE
  309.        SYNTAX INTEGER (0..2147483647)
  310.        ACCESS read-only
  311.        STATUS mandatory
  312.        DESCRIPTION
  313.               "The maximum number of process contexts this system
  314.               can support.  If there is no fixed maximum, the
  315.               value should be zero.  On systems that have a fixed
  316.               maximum, this object can help diagnose failures
  317.               that occur when this maximum is reached."
  318.        ::= { hrSystem 7 }
  319.  
  320.  
  321.    -- The Host Resources Storage Group
  322.    --
  323.    -- Implementation of this group is mandatory for all host systems.
  324.  
  325.    -- Registration for some storage types, for use with hrStorageType
  326.    hrStorageTypes          OBJECT IDENTIFIER ::= { hrStorage 1 }
  327.    hrStorageOther          OBJECT IDENTIFIER ::= { hrStorageTypes 1 }
  328.    hrStorageRam            OBJECT IDENTIFIER ::= { hrStorageTypes 2 }
  329.    -- hrStorageVirtualMemory is temporary storage of swapped
  330.    -- or paged memory
  331.    hrStorageVirtualMemory  OBJECT IDENTIFIER ::= { hrStorageTypes 3 }
  332.    hrStorageFixedDisk      OBJECT IDENTIFIER ::= { hrStorageTypes 4 }
  333.    hrStorageRemovableDisk  OBJECT IDENTIFIER ::= { hrStorageTypes 5 }
  334.    hrStorageFloppyDisk     OBJECT IDENTIFIER ::= { hrStorageTypes 6 }
  335.  
  336.  
  337.  
  338. Grillo & Waldbusser                                             [Page 6]
  339.  
  340. RFC 1514                   Host Resources MIB             September 1993
  341.  
  342.  
  343.    hrStorageCompactDisc    OBJECT IDENTIFIER ::= { hrStorageTypes 7 }
  344.    hrStorageRamDisk        OBJECT IDENTIFIER ::= { hrStorageTypes 8 }
  345.  
  346.    hrMemorySize OBJECT-TYPE
  347.        SYNTAX KBytes
  348.        ACCESS read-only
  349.        STATUS mandatory
  350.        DESCRIPTION
  351.               "The amount of physical main memory contained by
  352.               the host."
  353.        ::= { hrStorage 2 }
  354.  
  355.  
  356.    hrStorageTable OBJECT-TYPE
  357.        SYNTAX SEQUENCE OF HrStorageEntry
  358.        ACCESS not-accessible
  359.        STATUS mandatory
  360.        DESCRIPTION
  361.               "The (conceptual) table of logical storage areas on
  362.               the host.
  363.  
  364.               An entry shall be placed in the storage table for
  365.               each logical area of storage that is allocated and
  366.               has fixed resource limits.  The amount of storage
  367.               represented in an entity is the amount actually
  368.               usable by the requesting entity, and excludes loss
  369.               due to formatting or file system reference
  370.               information.
  371.  
  372.               These entries are associated with logical storage
  373.               areas, as might be seen by an application, rather
  374.               than physical storage entities which are typically
  375.               seen by an operating system.  Storage such as tapes
  376.               and floppies without file systems on them are
  377.               typically not allocated in chunks by the operating
  378.               system to requesting applications, and therefore
  379.               shouldn't appear in this table.  Examples of valid
  380.               storage for this table include disk partitions,
  381.               file systems, ram (for some architectures this is
  382.               further segmented into regular memory, extended
  383.               memory, and so on), backing store for virtual
  384.               memory (`swap space').
  385.  
  386.               This table is intended to be a useful diagnostic
  387.               for `out of memory' and `out of buffers' types of
  388.               failures.  In addition, it can be a useful
  389.               performance monitoring tool for tracking memory,
  390.               disk, or buffer usage."
  391.  
  392.  
  393.  
  394. Grillo & Waldbusser                                             [Page 7]
  395.  
  396. RFC 1514                   Host Resources MIB             September 1993
  397.  
  398.  
  399.        ::= { hrStorage 3 }
  400.  
  401.    hrStorageEntry OBJECT-TYPE
  402.        SYNTAX HrStorageEntry
  403.        ACCESS not-accessible
  404.        STATUS mandatory
  405.        DESCRIPTION
  406.               "A (conceptual) entry for one logical storage area
  407.               on the host.  As an example, an instance of the
  408.               hrStorageType object might be named
  409.               hrStorageType.3"
  410.        INDEX { hrStorageIndex }
  411.        ::= { hrStorageTable 1 }
  412.  
  413.    HrStorageEntry ::= SEQUENCE {
  414.            hrStorageIndex               INTEGER,
  415.            hrStorageType                OBJECT IDENTIFIER,
  416.            hrStorageDescr               DisplayString,
  417.            hrStorageAllocationUnits     INTEGER,
  418.            hrStorageSize                INTEGER,
  419.            hrStorageUsed                INTEGER,
  420.            hrStorageAllocationFailures  Counter
  421.        }
  422.  
  423.    hrStorageIndex OBJECT-TYPE
  424.        SYNTAX INTEGER (1..2147483647)
  425.        ACCESS read-only
  426.        STATUS mandatory
  427.        DESCRIPTION
  428.               "A unique value for each logical storage area
  429.               contained by the host."
  430.        ::= { hrStorageEntry 1 }
  431.  
  432.    hrStorageType OBJECT-TYPE
  433.        SYNTAX OBJECT IDENTIFIER
  434.        ACCESS read-only
  435.        STATUS mandatory
  436.        DESCRIPTION
  437.               "The type of storage represented by this entry."
  438.        ::= { hrStorageEntry 2 }
  439.  
  440.    hrStorageDescr OBJECT-TYPE
  441.        SYNTAX DisplayString
  442.        ACCESS read-only
  443.        STATUS mandatory
  444.        DESCRIPTION
  445.               "A description of the type and instance of the
  446.               storage described by this entry."
  447.  
  448.  
  449.  
  450. Grillo & Waldbusser                                             [Page 8]
  451.  
  452. RFC 1514                   Host Resources MIB             September 1993
  453.  
  454.  
  455.        ::= { hrStorageEntry 3 }
  456.  
  457.    hrStorageAllocationUnits OBJECT-TYPE
  458.        SYNTAX      INTEGER (1..2147483647)
  459.        ACCESS      read-only
  460.        STATUS      mandatory
  461.        DESCRIPTION
  462.                "The size, in bytes, of the data objects allocated
  463.                from this pool.  If this entry is monitoring
  464.                sectors, blocks, buffers, or packets, for example,
  465.                this number will commonly be greater than one.
  466.                Otherwise this number will typically be one."
  467.        ::= { hrStorageEntry 4 }
  468.  
  469.    hrStorageSize OBJECT-TYPE
  470.        SYNTAX INTEGER (0..2147483647)
  471.        ACCESS read-write
  472.        STATUS mandatory
  473.        DESCRIPTION
  474.               "The size of the storage represented by this entry,
  475.               in units of hrStorageAllocationUnits."
  476.        ::= { hrStorageEntry 5 }
  477.  
  478.    hrStorageUsed OBJECT-TYPE
  479.        SYNTAX INTEGER (0..2147483647)
  480.        ACCESS read-only
  481.        STATUS mandatory
  482.        DESCRIPTION
  483.               "The amount of the storage represented by this
  484.               entry that is allocated, in units of
  485.               hrStorageAllocationUnits."
  486.        ::= { hrStorageEntry 6 }
  487.  
  488.    hrStorageAllocationFailures OBJECT-TYPE
  489.        SYNTAX Counter
  490.        ACCESS read-only
  491.        STATUS mandatory
  492.        DESCRIPTION
  493.               "The number of requests for storage represented by
  494.               this entry that could not be honored due to not
  495.               enough storage.  It should be noted that as this
  496.               object has a SYNTAX of Counter, that it does not
  497.               have a defined initial value.  However, it is
  498.               recommended that this object be initialized to
  499.               zero."
  500.        ::= { hrStorageEntry 7 }
  501.  
  502.  
  503.  
  504.  
  505.  
  506. Grillo & Waldbusser                                             [Page 9]
  507.  
  508. RFC 1514                   Host Resources MIB             September 1993
  509.  
  510.  
  511.    -- The Host Resources Device Group
  512.    --
  513.    -- Implementation of this group is mandatory for all host systems.
  514.    --
  515.    -- The device group is useful for identifying and diagnosing the
  516.    -- devices on a system.  The hrDeviceTable contains common
  517.    -- information for any type of device.  In addition, some devices
  518.    -- have device-specific tables for more detailed information.  More
  519.    -- such tables may be defined in the future for other device types.
  520.  
  521.    -- Registration for some device types, for use with hrDeviceType
  522.    hrDeviceTypes             OBJECT IDENTIFIER ::= { hrDevice 1 }
  523.  
  524.    hrDeviceOther             OBJECT IDENTIFIER ::= { hrDeviceTypes 1 }
  525.    hrDeviceUnknown           OBJECT IDENTIFIER ::= { hrDeviceTypes 2 }
  526.    hrDeviceProcessor         OBJECT IDENTIFIER ::= { hrDeviceTypes 3 }
  527.    hrDeviceNetwork           OBJECT IDENTIFIER ::= { hrDeviceTypes 4 }
  528.    hrDevicePrinter           OBJECT IDENTIFIER ::= { hrDeviceTypes 5 }
  529.    hrDeviceDiskStorage       OBJECT IDENTIFIER ::= { hrDeviceTypes 6 }
  530.    hrDeviceVideo             OBJECT IDENTIFIER ::= { hrDeviceTypes 10 }
  531.    hrDeviceAudio             OBJECT IDENTIFIER ::= { hrDeviceTypes 11 }
  532.    hrDeviceCoprocessor       OBJECT IDENTIFIER ::= { hrDeviceTypes 12 }
  533.    hrDeviceKeyboard          OBJECT IDENTIFIER ::= { hrDeviceTypes 13 }
  534.    hrDeviceModem             OBJECT IDENTIFIER ::= { hrDeviceTypes 14 }
  535.    hrDeviceParallelPort      OBJECT IDENTIFIER ::= { hrDeviceTypes 15 }
  536.    hrDevicePointing          OBJECT IDENTIFIER ::= { hrDeviceTypes 16 }
  537.    hrDeviceSerialPort        OBJECT IDENTIFIER ::= { hrDeviceTypes 17 }
  538.    hrDeviceTape              OBJECT IDENTIFIER ::= { hrDeviceTypes 18 }
  539.    hrDeviceClock             OBJECT IDENTIFIER ::= { hrDeviceTypes 19 }
  540.    hrDeviceVolatileMemory    OBJECT IDENTIFIER ::= { hrDeviceTypes 20 }
  541.    hrDeviceNonVolatileMemory OBJECT IDENTIFIER ::= { hrDeviceTypes 21 }
  542.  
  543.  
  544.    hrDeviceTable OBJECT-TYPE
  545.        SYNTAX SEQUENCE OF HrDeviceEntry
  546.        ACCESS not-accessible
  547.        STATUS mandatory
  548.        DESCRIPTION
  549.               "The (conceptual) table of devices contained by the
  550.               host."
  551.        ::= { hrDevice 2 }
  552.  
  553.    hrDeviceEntry OBJECT-TYPE
  554.        SYNTAX HrDeviceEntry
  555.        ACCESS not-accessible
  556.        STATUS mandatory
  557.        DESCRIPTION
  558.               "A (conceptual) entry for one device contained by
  559.  
  560.  
  561.  
  562. Grillo & Waldbusser                                            [Page 10]
  563.  
  564. RFC 1514                   Host Resources MIB             September 1993
  565.  
  566.  
  567.               the host.  As an example, an instance of the
  568.               hrDeviceType object might be named hrDeviceType.3"
  569.        INDEX { hrDeviceIndex }
  570.        ::= { hrDeviceTable 1 }
  571.  
  572.    HrDeviceEntry ::= SEQUENCE {
  573.            hrDeviceIndex           INTEGER,
  574.            hrDeviceType            OBJECT IDENTIFIER,
  575.            hrDeviceDescr           DisplayString,
  576.            hrDeviceID              ProductID,
  577.            hrDeviceStatus          INTEGER,
  578.            hrDeviceErrors          Counter
  579.        }
  580.  
  581.    hrDeviceIndex OBJECT-TYPE
  582.        SYNTAX INTEGER (1..2147483647)
  583.        ACCESS read-only
  584.        STATUS mandatory
  585.        DESCRIPTION
  586.               "A unique value for each device contained by the
  587.               host.  The value for each device must remain
  588.               constant at least from one re-initialization of the
  589.               agent to the next re-initialization."
  590.        ::= { hrDeviceEntry 1 }
  591.  
  592.    hrDeviceType OBJECT-TYPE
  593.        SYNTAX OBJECT IDENTIFIER
  594.        ACCESS read-only
  595.        STATUS mandatory
  596.        DESCRIPTION
  597.               "An indication of the type of device.
  598.  
  599.               If this value is `hrDeviceProcessor { hrDeviceTypes
  600.               3 }' then an entry exists in the hrProcessorTable
  601.               which corresponds to this device.
  602.  
  603.               If this value is `hrDeviceNetwork { hrDeviceTypes 4
  604.               }', then an entry exists in the hrNetworkTable
  605.               which corresponds to this device.
  606.  
  607.               If this value is `hrDevicePrinter { hrDeviceTypes 5
  608.               }', then an entry exists in the hrPrinterTable
  609.               which corresponds to this device.
  610.  
  611.               If this value is `hrDeviceDiskStorage {
  612.               hrDeviceTypes 6 }', then an entry exists in the
  613.               hrDiskStorageTable which corresponds to this
  614.               device."
  615.  
  616.  
  617.  
  618. Grillo & Waldbusser                                            [Page 11]
  619.  
  620. RFC 1514                   Host Resources MIB             September 1993
  621.  
  622.  
  623.        ::= { hrDeviceEntry 2 }
  624.  
  625.    hrDeviceDescr OBJECT-TYPE
  626.        SYNTAX DisplayString (SIZE (0..64))
  627.        ACCESS read-only
  628.        STATUS mandatory
  629.        DESCRIPTION
  630.               "A textual description of this device, including
  631.               the device's manufacturer and revision, and
  632.               optionally, its serial number."
  633.        ::= { hrDeviceEntry 3 }
  634.  
  635.    hrDeviceID OBJECT-TYPE
  636.        SYNTAX ProductID
  637.        ACCESS read-only
  638.        STATUS mandatory
  639.        DESCRIPTION
  640.               "The product ID for this device."
  641.        ::= { hrDeviceEntry 4 }
  642.  
  643.    hrDeviceStatus OBJECT-TYPE
  644.         SYNTAX  INTEGER {
  645.              unknown(1),
  646.              running(2),
  647.              warning(3),
  648.              testing(4),
  649.              down(5)
  650.         }
  651.         ACCESS  read-only
  652.         STATUS  mandatory
  653.         DESCRIPTION
  654.               "The current operational state of the device
  655.               described by this row of the table.  A value
  656.               unknown(1) indicates that the current state of the
  657.               device is unknown.  running(2) indicates that the
  658.               device is up and running and that no unusual error
  659.               conditions are known.  The warning(3) state
  660.               indicates that agent has been informed of an
  661.               unusual error condition by the operational software
  662.               (e.g., a disk device driver) but that the device is
  663.               still 'operational'.  An example would be high
  664.               number of soft errors on a disk.  A value of
  665.               testing(4), indicates that the device is not
  666.               available for use because it is in the testing
  667.               state.  The state of down(5) is used only when the
  668.               agent has been informed that the device is not
  669.               available for any use."
  670.         ::= { hrDeviceEntry 5 }
  671.  
  672.  
  673.  
  674. Grillo & Waldbusser                                            [Page 12]
  675.  
  676. RFC 1514                   Host Resources MIB             September 1993
  677.  
  678.  
  679.    hrDeviceErrors OBJECT-TYPE
  680.        SYNTAX Counter
  681.        ACCESS read-only
  682.        STATUS mandatory
  683.        DESCRIPTION
  684.                "The number of errors detected on this device.  It
  685.                should be noted that as this object has a SYNTAX
  686.                of Counter, that it does not have a defined
  687.                initial value.  However, it is recommended that
  688.                this object be initialized to zero."
  689.        ::= { hrDeviceEntry 6 }
  690.  
  691.    hrProcessorTable OBJECT-TYPE
  692.        SYNTAX SEQUENCE OF HrProcessorEntry
  693.        ACCESS not-accessible
  694.        STATUS mandatory
  695.        DESCRIPTION
  696.               "The (conceptual) table of processors contained by
  697.               the host.
  698.  
  699.               Note that this table is potentially sparse: a
  700.               (conceptual) entry exists only if the correspondent
  701.               value of the hrDeviceType object is
  702.               `hrDeviceProcessor'."
  703.        ::= { hrDevice 3 }
  704.  
  705.    hrProcessorEntry OBJECT-TYPE
  706.        SYNTAX HrProcessorEntry
  707.        ACCESS not-accessible
  708.        STATUS mandatory
  709.        DESCRIPTION
  710.               "A (conceptual) entry for one processor contained
  711.               by the host.  The hrDeviceIndex in the index
  712.               represents the entry in the hrDeviceTable that
  713.               corresponds to the hrProcessorEntry.
  714.  
  715.               As an example of how objects in this table are
  716.               named, an instance of the hrProcessorFrwID object
  717.               might be named hrProcessorFrwID.3"
  718.        INDEX { hrDeviceIndex }
  719.        ::= { hrProcessorTable 1 }
  720.  
  721.    HrProcessorEntry ::= SEQUENCE {
  722.            hrProcessorFrwID            ProductID,
  723.            hrProcessorLoad             INTEGER
  724.        }
  725.  
  726.    hrProcessorFrwID OBJECT-TYPE
  727.  
  728.  
  729.  
  730. Grillo & Waldbusser                                            [Page 13]
  731.  
  732. RFC 1514                   Host Resources MIB             September 1993
  733.  
  734.  
  735.        SYNTAX ProductID
  736.        ACCESS read-only
  737.        STATUS mandatory
  738.        DESCRIPTION
  739.               "The product ID of the firmware associated with the
  740.               processor."
  741.        ::= { hrProcessorEntry 1 }
  742.  
  743.    hrProcessorLoad OBJECT-TYPE
  744.        SYNTAX INTEGER (0..100)
  745.        ACCESS read-only
  746.        STATUS mandatory
  747.        DESCRIPTION
  748.               "The average, over the last minute, of the
  749.               percentage of time that this processor was not
  750.               idle."
  751.        ::= { hrProcessorEntry 2 }
  752.  
  753.    hrNetworkTable OBJECT-TYPE
  754.        SYNTAX SEQUENCE OF HrNetworkEntry
  755.        ACCESS not-accessible
  756.        STATUS mandatory
  757.        DESCRIPTION
  758.               "The (conceptual) table of network devices
  759.               contained by the host.
  760.  
  761.               Note that this table is potentially sparse: a
  762.               (conceptual) entry exists only if the correspondent
  763.               value of the hrDeviceType object is
  764.               `hrDeviceNetwork'."
  765.        ::= { hrDevice 4 }
  766.  
  767.    hrNetworkEntry OBJECT-TYPE
  768.        SYNTAX HrNetworkEntry
  769.        ACCESS not-accessible
  770.        STATUS mandatory
  771.        DESCRIPTION
  772.               "A (conceptual) entry for one network device
  773.               contained by the host.  The hrDeviceIndex in the
  774.               index represents the entry in the hrDeviceTable
  775.               that corresponds to the hrNetworkEntry.
  776.  
  777.               As an example of how objects in this table are
  778.               named, an instance of the hrNetworkIfIndex object
  779.               might be named hrNetworkIfIndex.3"
  780.        INDEX { hrDeviceIndex }
  781.        ::= { hrNetworkTable 1 }
  782.  
  783.  
  784.  
  785.  
  786. Grillo & Waldbusser                                            [Page 14]
  787.  
  788. RFC 1514                   Host Resources MIB             September 1993
  789.  
  790.  
  791.    HrNetworkEntry ::= SEQUENCE {
  792.            hrNetworkIfIndex    INTEGER
  793.        }
  794.  
  795.    hrNetworkIfIndex OBJECT-TYPE
  796.        SYNTAX INTEGER
  797.        ACCESS read-only
  798.        STATUS mandatory
  799.        DESCRIPTION
  800.               "The value of ifIndex which corresponds to this
  801.               network device."
  802.        ::= { hrNetworkEntry 1 }
  803.  
  804.    hrPrinterTable OBJECT-TYPE
  805.        SYNTAX SEQUENCE OF HrPrinterEntry
  806.        ACCESS not-accessible
  807.        STATUS mandatory
  808.        DESCRIPTION
  809.               "The (conceptual) table of printers local to the
  810.               host.
  811.  
  812.               Note that this table is potentially sparse: a
  813.               (conceptual) entry exists only if the correspondent
  814.               value of the hrDeviceType object is
  815.               `hrDevicePrinter'."
  816.        ::= { hrDevice 5 }
  817.  
  818.    hrPrinterEntry OBJECT-TYPE
  819.        SYNTAX HrPrinterEntry
  820.        ACCESS not-accessible
  821.        STATUS mandatory
  822.        DESCRIPTION
  823.               "A (conceptual) entry for one printer local to the
  824.               host.  The hrDeviceIndex in the index represents
  825.               the entry in the hrDeviceTable that corresponds to
  826.               the hrPrinterEntry.
  827.  
  828.               As an example of how objects in this table are
  829.               named, an instance of the hrPrinterStatus object
  830.               might be named hrPrinterStatus.3"
  831.        INDEX { hrDeviceIndex }
  832.        ::= { hrPrinterTable 1 }
  833.  
  834.    HrPrinterEntry ::= SEQUENCE {
  835.            hrPrinterStatus             INTEGER,
  836.            hrPrinterDetectedErrorState OCTET STRING
  837.        }
  838.  
  839.  
  840.  
  841.  
  842. Grillo & Waldbusser                                            [Page 15]
  843.  
  844. RFC 1514                   Host Resources MIB             September 1993
  845.  
  846.  
  847.    hrPrinterStatus OBJECT-TYPE
  848.        SYNTAX INTEGER {
  849.            other(1),
  850.            unknown(2),
  851.            idle(3),
  852.            printing(4),
  853.            warmup(5)
  854.        }
  855.        ACCESS read-only
  856.        STATUS mandatory
  857.        DESCRIPTION
  858.                "The current status of this printer device.  When
  859.                in the idle(1), printing(2), or warmup(3) state,
  860.                the corresponding hrDeviceStatus should be
  861.                running(2) or warning(3).  When in the unknown
  862.                state, the corresponding hrDeviceStatus should be
  863.                unknown(1)."
  864.        ::= { hrPrinterEntry 1 }
  865.  
  866.    hrPrinterDetectedErrorState OBJECT-TYPE
  867.        SYNTAX OCTET STRING
  868.        ACCESS read-only
  869.        STATUS mandatory
  870.        DESCRIPTION
  871.                "This object represents any error conditions
  872.                detected by the printer.  The error conditions are
  873.                encoded as bits in an octet string, with the
  874.                following definitions:
  875.  
  876.                     Condition         Bit #    hrDeviceStatus
  877.  
  878.                     lowPaper          0        warning(3)
  879.                     noPaper           1        down(5)
  880.                     lowToner          2        warning(3)
  881.                     noToner           3        down(5)
  882.                     doorOpen          4        down(5)
  883.                     jammed            5        down(5)
  884.                     offline           6        down(5)
  885.                     serviceRequested  7        warning(3)
  886.  
  887.                If multiple conditions are currently detected and
  888.                the hrDeviceStatus would not otherwise be
  889.                unknown(1) or testing(4), the hrDeviceStatus shall
  890.                correspond to the worst state of those indicated,
  891.                where down(5) is worse than warning(3) which is
  892.                worse than running(2).
  893.  
  894.                Bits are numbered starting with the most
  895.  
  896.  
  897.  
  898. Grillo & Waldbusser                                            [Page 16]
  899.  
  900. RFC 1514                   Host Resources MIB             September 1993
  901.  
  902.  
  903.                significant bit of the first byte being bit 0, the
  904.                least significant bit of the first byte being bit
  905.                7, the most significant bit of the second byte
  906.                being bit 8, and so on.  A one bit encodes that
  907.                the condition was detected, while a zero bit
  908.                encodes that the condition was not detected.
  909.  
  910.                This object is useful for alerting an operator to
  911.                specific warning or error conditions that may
  912.                occur, especially those requiring human
  913.                intervention."
  914.        ::= { hrPrinterEntry 2 }
  915.  
  916.    hrDiskStorageTable OBJECT-TYPE
  917.        SYNTAX SEQUENCE OF HrDiskStorageEntry
  918.        ACCESS not-accessible
  919.        STATUS mandatory
  920.        DESCRIPTION
  921.               "The (conceptual) table of long-term storage
  922.               devices contained by the host.  In particular, disk
  923.               devices accessed remotely over a network are not
  924.               included here.
  925.  
  926.               Note that this table is potentially sparse: a
  927.               (conceptual) entry exists only if the correspondent
  928.               value of the hrDeviceType object is
  929.               `hrDeviceDiskStorage'."
  930.        ::= { hrDevice 6 }
  931.  
  932.    hrDiskStorageEntry OBJECT-TYPE
  933.        SYNTAX HrDiskStorageEntry
  934.        ACCESS not-accessible
  935.        STATUS mandatory
  936.        DESCRIPTION
  937.               "A (conceptual) entry for one long-term storage
  938.               device contained by the host.  The hrDeviceIndex in
  939.               the index represents the entry in the hrDeviceTable
  940.               that corresponds to the hrDiskStorageEntry. As an
  941.               example, an instance of the hrDiskStorageCapacity
  942.               object might be named hrDiskStorageCapacity.3"
  943.        INDEX { hrDeviceIndex }
  944.        ::= { hrDiskStorageTable 1 }
  945.  
  946.    HrDiskStorageEntry ::= SEQUENCE {
  947.            hrDiskStorageAccess         INTEGER,
  948.            hrDiskStorageMedia          INTEGER,
  949.            hrDiskStorageRemoveble      Boolean,
  950.            hrDiskStorageCapacity       KBytes
  951.  
  952.  
  953.  
  954. Grillo & Waldbusser                                            [Page 17]
  955.  
  956. RFC 1514                   Host Resources MIB             September 1993
  957.  
  958.  
  959.        }
  960.  
  961.    hrDiskStorageAccess OBJECT-TYPE
  962.        SYNTAX INTEGER {
  963.                        readWrite(1),
  964.                        readOnly(2)
  965.                }
  966.        ACCESS read-only
  967.        STATUS mandatory
  968.        DESCRIPTION
  969.               "An indication if this long-term storage device is
  970.               readable and writable or only readable.  This
  971.               should reflect the media type, any write-protect
  972.               mechanism, and any device configuration that
  973.               affects the entire device."
  974.        ::= { hrDiskStorageEntry 1 }
  975.  
  976.    hrDiskStorageMedia OBJECT-TYPE
  977.        SYNTAX INTEGER {
  978.                    other(1),
  979.                    unknown(2),
  980.                    hardDisk(3),
  981.                    floppyDisk(4),
  982.                    opticalDiskROM(5),
  983.                    opticalDiskWORM(6),     -- Write Once Read Many
  984.                    opticalDiskRW(7),
  985.                    ramDisk(8)
  986.                }
  987.        ACCESS read-only
  988.        STATUS mandatory
  989.        DESCRIPTION
  990.               "An indication of the type of media used in this
  991.               long-term storage device."
  992.        ::= { hrDiskStorageEntry 2 }
  993.  
  994.    hrDiskStorageRemoveble OBJECT-TYPE
  995.        SYNTAX Boolean
  996.        ACCESS read-only
  997.        STATUS mandatory
  998.        DESCRIPTION
  999.                "Denotes whether or not the disk media may be
  1000.                removed from the drive."
  1001.        ::= { hrDiskStorageEntry 3 }
  1002.  
  1003.    hrDiskStorageCapacity OBJECT-TYPE
  1004.        SYNTAX KBytes
  1005.        ACCESS read-only
  1006.        STATUS mandatory
  1007.  
  1008.  
  1009.  
  1010. Grillo & Waldbusser                                            [Page 18]
  1011.  
  1012. RFC 1514                   Host Resources MIB             September 1993
  1013.  
  1014.  
  1015.        DESCRIPTION
  1016.               "The total size for this long-term storage device."
  1017.        ::= { hrDiskStorageEntry 4 }
  1018.  
  1019.    hrPartitionTable OBJECT-TYPE
  1020.        SYNTAX SEQUENCE OF HrPartitionEntry
  1021.        ACCESS not-accessible
  1022.        STATUS mandatory
  1023.        DESCRIPTION
  1024.               "The (conceptual) table of partitions for long-term
  1025.               storage devices contained by the host.  In
  1026.               particular, partitions accessed remotely over a
  1027.               network are not included here."
  1028.        ::= { hrDevice 7 }
  1029.  
  1030.    hrPartitionEntry OBJECT-TYPE
  1031.        SYNTAX HrPartitionEntry
  1032.        ACCESS not-accessible
  1033.        STATUS mandatory
  1034.        DESCRIPTION
  1035.               "A (conceptual) entry for one partition.  The
  1036.               hrDeviceIndex in the index represents the entry in
  1037.               the hrDeviceTable that corresponds to the
  1038.               hrPartitionEntry.
  1039.  
  1040.               As an example of how objects in this table are
  1041.               named, an instance of the hrPartitionSize object
  1042.               might be named hrPartitionSize.3.1"
  1043.        INDEX { hrDeviceIndex, hrPartitionIndex }
  1044.        ::= { hrPartitionTable 1 }
  1045.  
  1046.    HrPartitionEntry ::= SEQUENCE {
  1047.            hrPartitionIndex                INTEGER,
  1048.            hrPartitionLabel                InternationalDisplayString,
  1049.            hrPartitionID                   OCTET STRING,
  1050.            hrPartitionSize                 KBytes,
  1051.            hrPartitionFSIndex              INTEGER
  1052.        }
  1053.  
  1054.    hrPartitionIndex OBJECT-TYPE
  1055.        SYNTAX INTEGER (1..2147483647)
  1056.        ACCESS read-only
  1057.        STATUS mandatory
  1058.        DESCRIPTION
  1059.               "A unique value for each partition on this long-
  1060.               term storage device.  The value for each long-term
  1061.               storage device must remain constant at least from
  1062.               one re-initialization of the agent to the next re-
  1063.  
  1064.  
  1065.  
  1066. Grillo & Waldbusser                                            [Page 19]
  1067.  
  1068. RFC 1514                   Host Resources MIB             September 1993
  1069.  
  1070.  
  1071.               initialization."
  1072.        ::= { hrPartitionEntry 1 }
  1073.  
  1074.    hrPartitionLabel OBJECT-TYPE
  1075.        SYNTAX InternationalDisplayString (SIZE (0..128))
  1076.        ACCESS read-only
  1077.        STATUS mandatory
  1078.        DESCRIPTION
  1079.               "A textual description of this partition."
  1080.        ::= { hrPartitionEntry 2 }
  1081.  
  1082.    hrPartitionID OBJECT-TYPE
  1083.        SYNTAX OCTET STRING
  1084.        ACCESS read-only
  1085.        STATUS mandatory
  1086.        DESCRIPTION
  1087.               "A descriptor which uniquely represents this
  1088.               partition to the responsible operating system.  On
  1089.               some systems, this might take on a binary
  1090.               representation."
  1091.        ::= { hrPartitionEntry 3 }
  1092.  
  1093.    hrPartitionSize OBJECT-TYPE
  1094.        SYNTAX KBytes
  1095.        ACCESS read-only
  1096.        STATUS mandatory
  1097.        DESCRIPTION
  1098.                "The size of this partition."
  1099.        ::= { hrPartitionEntry 4 }
  1100.  
  1101.    hrPartitionFSIndex OBJECT-TYPE
  1102.        SYNTAX INTEGER (0..2147483647)
  1103.        ACCESS read-only
  1104.        STATUS mandatory
  1105.        DESCRIPTION
  1106.                "The index of the file system mounted on this
  1107.                partition.  If no file system is mounted on this
  1108.                partition, then this value shall be zero.  Note
  1109.                that multiple partitions may point to one file
  1110.                system, denoting that that file system resides on
  1111.                those partitions.  Multiple file systems may not
  1112.                reside on one partition."
  1113.        ::= { hrPartitionEntry 5 }
  1114.  
  1115.  
  1116.    -- The File System Table
  1117.    hrFSTable OBJECT-TYPE
  1118.        SYNTAX SEQUENCE OF HrFSEntry
  1119.  
  1120.  
  1121.  
  1122. Grillo & Waldbusser                                            [Page 20]
  1123.  
  1124. RFC 1514                   Host Resources MIB             September 1993
  1125.  
  1126.  
  1127.        ACCESS not-accessible
  1128.        STATUS mandatory
  1129.        DESCRIPTION
  1130.                "The (conceptual) table of file systems local to
  1131.                this host or remotely mounted from a file server.
  1132.                File systems that are in only one user's
  1133.                environment on a multi-user system will not be
  1134.                included in this table."
  1135.        ::= { hrDevice 8 }
  1136.  
  1137.    hrFSEntry OBJECT-TYPE
  1138.        SYNTAX HrFSEntry
  1139.        ACCESS not-accessible
  1140.        STATUS mandatory
  1141.        DESCRIPTION
  1142.                "A (conceptual) entry for one file system local to
  1143.                this host or remotely mounted from a file server.
  1144.                File systems that are in only one user's
  1145.                environment on a multi-user system will not be
  1146.                included in this table.
  1147.  
  1148.                As an example of how objects in this table are
  1149.                named, an instance of the hrFSMountPoint object
  1150.                might be named hrFSMountPoint.3"
  1151.        INDEX { hrFSIndex }
  1152.        ::= { hrFSTable 1 }
  1153.  
  1154.    -- Registration for some popular File System types,
  1155.    -- for use with hrFSType.
  1156.  
  1157.    hrFSTypes               OBJECT IDENTIFIER ::= { hrDevice 9 }
  1158.  
  1159.    hrFSOther               OBJECT IDENTIFIER ::= { hrFSTypes 1 }
  1160.    hrFSUnknown             OBJECT IDENTIFIER ::= { hrFSTypes 2 }
  1161.    hrFSBerkeleyFFS         OBJECT IDENTIFIER ::= { hrFSTypes 3 }
  1162.    hrFSSys5FS              OBJECT IDENTIFIER ::= { hrFSTypes 4 }
  1163.    -- DOS
  1164.    hrFSFat                 OBJECT IDENTIFIER ::= { hrFSTypes 5 }
  1165.    -- OS/2 High Performance File System
  1166.    hrFSHPFS                OBJECT IDENTIFIER ::= { hrFSTypes 6 }
  1167.    --  Macintosh Hierarchical File System
  1168.    hrFSHFS                 OBJECT IDENTIFIER ::= { hrFSTypes 7 }
  1169.  
  1170.  
  1171.    -- Macintosh File System
  1172.    hrFSMFS                 OBJECT IDENTIFIER ::= { hrFSTypes 8 }
  1173.    -- Windows NT
  1174.    hrFSNTFS                OBJECT IDENTIFIER ::= { hrFSTypes 9 }
  1175.  
  1176.  
  1177.  
  1178. Grillo & Waldbusser                                            [Page 21]
  1179.  
  1180. RFC 1514                   Host Resources MIB             September 1993
  1181.  
  1182.  
  1183.    hrFSVNode               OBJECT IDENTIFIER ::= { hrFSTypes 10 }
  1184.    hrFSJournaled           OBJECT IDENTIFIER ::= { hrFSTypes 11 }
  1185.    -- CD File systems
  1186.    hrFSiso9660             OBJECT IDENTIFIER ::= { hrFSTypes 12 }
  1187.    hrFSRockRidge           OBJECT IDENTIFIER ::= { hrFSTypes 13 }
  1188.  
  1189.    hrFSNFS                 OBJECT IDENTIFIER ::= { hrFSTypes 14 }
  1190.    hrFSNetware             OBJECT IDENTIFIER ::= { hrFSTypes 15 }
  1191.    -- Andrew File System
  1192.    hrFSAFS                 OBJECT IDENTIFIER ::= { hrFSTypes 16 }
  1193.    -- OSF DCE Distributed File System
  1194.    hrFSDFS                 OBJECT IDENTIFIER ::= { hrFSTypes 17 }
  1195.    hrFSAppleshare          OBJECT IDENTIFIER ::= { hrFSTypes 18 }
  1196.    hrFSRFS                 OBJECT IDENTIFIER ::= { hrFSTypes 19 }
  1197.    -- Data General
  1198.    hrFSDGCFS               OBJECT IDENTIFIER ::= { hrFSTypes 20 }
  1199.    -- SVR4 Boot File System
  1200.    hrFSBFS                 OBJECT IDENTIFIER ::= { hrFSTypes 21 }
  1201.  
  1202.  
  1203.  
  1204.    HrFSEntry ::= SEQUENCE {
  1205.            hrFSIndex                   INTEGER,
  1206.            hrFSMountPoint              InternationalDisplayString,
  1207.            hrFSRemoteMountPoint        InternationalDisplayString,
  1208.            hrFSType                    OBJECT IDENTIFIER,
  1209.            hrFSAccess                  INTEGER,
  1210.            hrFSBootable                Boolean,
  1211.            hrFSStorageIndex            INTEGER,
  1212.            hrFSLastFullBackupDate      DateAndTime,
  1213.            hrFSLastPartialBackupDate   DateAndTime
  1214.        }
  1215.  
  1216.    hrFSIndex OBJECT-TYPE
  1217.        SYNTAX INTEGER (1..2147483647)
  1218.        ACCESS read-only
  1219.        STATUS mandatory
  1220.        DESCRIPTION
  1221.                "A unique value for each file system local to this
  1222.                host.  The value for each file system must remain
  1223.                constant at least from one re-initialization of
  1224.                the agent to the next re-initialization."
  1225.        ::= { hrFSEntry 1 }
  1226.  
  1227.    hrFSMountPoint OBJECT-TYPE
  1228.        SYNTAX InternationalDisplayString (SIZE(0..128))
  1229.        ACCESS read-only
  1230.        STATUS mandatory
  1231.  
  1232.  
  1233.  
  1234. Grillo & Waldbusser                                            [Page 22]
  1235.  
  1236. RFC 1514                   Host Resources MIB             September 1993
  1237.  
  1238.  
  1239.        DESCRIPTION
  1240.                "The path name of the root of this file system."
  1241.        ::= { hrFSEntry 2 }
  1242.  
  1243.    hrFSRemoteMountPoint OBJECT-TYPE
  1244.        SYNTAX InternationalDisplayString (SIZE(0..128))
  1245.        ACCESS read-only
  1246.        STATUS mandatory
  1247.        DESCRIPTION
  1248.                "A description of the name and/or address of the
  1249.                server that this file system is mounted from.
  1250.                This may also include parameters such as the mount
  1251.                point on the remote file system.  If this is not a
  1252.                remote file system, this string should have a
  1253.                length of zero."
  1254.        ::= { hrFSEntry 3 }
  1255.  
  1256.    hrFSType OBJECT-TYPE
  1257.        SYNTAX OBJECT IDENTIFIER
  1258.        ACCESS read-only
  1259.        STATUS mandatory
  1260.        DESCRIPTION
  1261.               "The value of this object identifies the type of
  1262.               this file system."
  1263.        ::= { hrFSEntry 4 }
  1264.  
  1265.    hrFSAccess OBJECT-TYPE
  1266.        SYNTAX INTEGER {
  1267.                readWrite(1),
  1268.                readOnly(2)
  1269.            }
  1270.        ACCESS read-only
  1271.        STATUS mandatory
  1272.        DESCRIPTION
  1273.               "An indication if this file system is logically
  1274.               configured by the operating system to be readable
  1275.               and writable or only readable.  This does not
  1276.               represent any local access-control policy, except
  1277.               one that is applied to the file system as a whole."
  1278.        ::= { hrFSEntry 5 }
  1279.  
  1280.    hrFSBootable OBJECT-TYPE
  1281.        SYNTAX Boolean
  1282.        ACCESS read-only
  1283.        STATUS mandatory
  1284.        DESCRIPTION
  1285.               "A flag indicating whether this file system is
  1286.               bootable."
  1287.  
  1288.  
  1289.  
  1290. Grillo & Waldbusser                                            [Page 23]
  1291.  
  1292. RFC 1514                   Host Resources MIB             September 1993
  1293.  
  1294.  
  1295.        ::= { hrFSEntry 6 }
  1296.  
  1297.    hrFSStorageIndex OBJECT-TYPE
  1298.        SYNTAX INTEGER (0..2147483647)
  1299.        ACCESS read-only
  1300.        STATUS mandatory
  1301.        DESCRIPTION
  1302.                "The index of the hrStorageEntry that represents
  1303.                information about this file system.  If there is
  1304.                no such information available, then this value
  1305.                shall be zero.  The relevant storage entry will be
  1306.                useful in tracking the percent usage of this file
  1307.                system and diagnosing errors that may occur when
  1308.                it runs out of space."
  1309.        ::= { hrFSEntry 7 }
  1310.  
  1311.    hrFSLastFullBackupDate OBJECT-TYPE
  1312.        SYNTAX DateAndTime
  1313.        ACCESS read-write
  1314.        STATUS mandatory
  1315.        DESCRIPTION
  1316.               "The last date at which this complete file system
  1317.               was copied to another storage device for backup.
  1318.               This information is useful for ensuring that
  1319.               backups are being performed regularly.
  1320.  
  1321.               If this information is not known, then this
  1322.               variable shall have the value corresponding to
  1323.               January 1, year 0000, 00:00:00.0, which is encoded
  1324.               as (hex)'00 00 01 01 00 00 00 00'."
  1325.        ::= { hrFSEntry 8 }
  1326.  
  1327.    hrFSLastPartialBackupDate OBJECT-TYPE
  1328.        SYNTAX DateAndTime
  1329.        ACCESS read-write
  1330.        STATUS mandatory
  1331.        DESCRIPTION
  1332.               "The last date at which a portion of this file
  1333.               system was copied to another storage device for
  1334.               backup.  This information is useful for ensuring
  1335.               that backups are being performed regularly.
  1336.  
  1337.               If this information is not known, then this
  1338.               variable shall have the value corresponding to
  1339.               January 1, year 0000, 00:00:00.0, which is encoded
  1340.               as (hex)'00 00 01 01 00 00 00 00'."
  1341.        ::= { hrFSEntry 9 }
  1342.  
  1343.  
  1344.  
  1345.  
  1346. Grillo & Waldbusser                                            [Page 24]
  1347.  
  1348. RFC 1514                   Host Resources MIB             September 1993
  1349.  
  1350.  
  1351.    -- The Host Resources Running Software Group
  1352.    --
  1353.    -- Implementation of this group is optional.
  1354.    --
  1355.    -- The hrSWRunTable contains an entry for each distinct piece of
  1356.    -- software that is running or loaded into physical or virtual
  1357.    -- memory in preparation for running.  This includes the host's
  1358.    -- operating system, device drivers, and applications.
  1359.  
  1360.    hrSWOSIndex OBJECT-TYPE
  1361.        SYNTAX INTEGER (1..2147483647)
  1362.        ACCESS read-only
  1363.        STATUS mandatory
  1364.        DESCRIPTION
  1365.                "The value of the hrSWRunIndex for the
  1366.                hrSWRunEntry that represents the primary operating
  1367.                system running on this host.  This object is
  1368.                useful for quickly and uniquely identifying that
  1369.                primary operating system."
  1370.        ::= { hrSWRun 1 }
  1371.  
  1372.    hrSWRunTable OBJECT-TYPE
  1373.        SYNTAX SEQUENCE OF HrSWRunEntry
  1374.        ACCESS not-accessible
  1375.        STATUS mandatory
  1376.        DESCRIPTION
  1377.               "The (conceptual) table of software running on the
  1378.               host."
  1379.        ::= { hrSWRun 2 }
  1380.  
  1381.    hrSWRunEntry OBJECT-TYPE
  1382.        SYNTAX HrSWRunEntry
  1383.        ACCESS not-accessible
  1384.        STATUS mandatory
  1385.        DESCRIPTION
  1386.               "A (conceptual) entry for one piece of software
  1387.               running on the host Note that because the installed
  1388.               software table only contains information for
  1389.               software stored locally on this host, not every
  1390.               piece of running software will be found in the
  1391.               installed software table.  This is true of software
  1392.               that was loaded and run from a non-local source,
  1393.               such as a network-mounted file system.
  1394.  
  1395.               As an example of how objects in this table are
  1396.               named, an instance of the hrSWRunName object might
  1397.               be named hrSWRunName.1287"
  1398.        INDEX { hrSWRunIndex }
  1399.  
  1400.  
  1401.  
  1402. Grillo & Waldbusser                                            [Page 25]
  1403.  
  1404. RFC 1514                   Host Resources MIB             September 1993
  1405.  
  1406.  
  1407.        ::= { hrSWRunTable 1 }
  1408.  
  1409.    HrSWRunEntry ::= SEQUENCE {
  1410.            hrSWRunIndex       INTEGER,
  1411.            hrSWRunName        InternationalDisplayString,
  1412.            hrSWRunID          ProductID,
  1413.            hrSWRunPath        InternationalDisplayString,
  1414.            hrSWRunParameters  InternationalDisplayString,
  1415.            hrSWRunType        INTEGER,
  1416.            hrSWRunStatus      INTEGER
  1417.        }
  1418.  
  1419.    hrSWRunIndex OBJECT-TYPE
  1420.        SYNTAX INTEGER (1..2147483647)
  1421.        ACCESS read-only
  1422.        STATUS mandatory
  1423.        DESCRIPTION
  1424.               "A unique value for each piece of software running
  1425.               on the host.  Wherever possible, this should be the
  1426.               system's native, unique identification number."
  1427.        ::= { hrSWRunEntry 1 }
  1428.  
  1429.    hrSWRunName OBJECT-TYPE
  1430.        SYNTAX InternationalDisplayString (SIZE (0..64))
  1431.        ACCESS read-only
  1432.        STATUS mandatory
  1433.        DESCRIPTION
  1434.               "A textual description of this running piece of
  1435.               software, including the manufacturer, revision,
  1436.               and the name by which it is commonly known.  If
  1437.               this software was installed locally, this should be
  1438.               the same string as used in the corresponding
  1439.               hrSWInstalledName."
  1440.        ::= { hrSWRunEntry 2 }
  1441.  
  1442.    hrSWRunID OBJECT-TYPE
  1443.        SYNTAX ProductID
  1444.        ACCESS read-only
  1445.        STATUS mandatory
  1446.        DESCRIPTION
  1447.               "The product ID of this running piece of software."
  1448.        ::= { hrSWRunEntry 3 }
  1449.  
  1450.    hrSWRunPath OBJECT-TYPE
  1451.        SYNTAX InternationalDisplayString (SIZE(0..128))
  1452.        ACCESS read-only
  1453.        STATUS mandatory
  1454.        DESCRIPTION
  1455.  
  1456.  
  1457.  
  1458. Grillo & Waldbusser                                            [Page 26]
  1459.  
  1460. RFC 1514                   Host Resources MIB             September 1993
  1461.  
  1462.  
  1463.               "A description of the location on long-term storage
  1464.               (e.g. a disk drive) from which this software was
  1465.               loaded."
  1466.        ::= { hrSWRunEntry 4 }
  1467.  
  1468.    hrSWRunParameters OBJECT-TYPE
  1469.        SYNTAX InternationalDisplayString (SIZE(0..128))
  1470.        ACCESS read-only
  1471.        STATUS mandatory
  1472.        DESCRIPTION
  1473.               "A description of the parameters supplied to this
  1474.               software when it was initially loaded."
  1475.        ::= { hrSWRunEntry 5 }
  1476.  
  1477.    hrSWRunType OBJECT-TYPE
  1478.        SYNTAX INTEGER {
  1479.                    unknown(1),
  1480.                    operatingSystem(2),
  1481.                    deviceDriver(3),
  1482.                    application(4)
  1483.               }
  1484.        ACCESS read-only
  1485.        STATUS mandatory
  1486.        DESCRIPTION
  1487.                "The type of this software."
  1488.        ::= { hrSWRunEntry 6 }
  1489.  
  1490.    hrSWRunStatus OBJECT-TYPE
  1491.        SYNTAX INTEGER {
  1492.                running(1),
  1493.                runnable(2),    -- waiting for resource (CPU, memory, IO)
  1494.                notRunnable(3), -- loaded but waiting for event
  1495.                invalid(4)      -- not loaded
  1496.            }
  1497.        ACCESS read-write
  1498.        STATUS mandatory
  1499.        DESCRIPTION
  1500.               "The status of this running piece of software.
  1501.               Setting this value to invalid(4) shall cause this
  1502.               software to stop running and to be unloaded."
  1503.        ::= { hrSWRunEntry 7 }
  1504.  
  1505.  
  1506.    -- The Host Resources Running Software Performance Group
  1507.    -- Implementation of this group is optional.
  1508.    --
  1509.    -- The hrSWRunPerfTable contains an entry corresponding to
  1510.    -- each entry in the hrSWRunTable.
  1511.  
  1512.  
  1513.  
  1514. Grillo & Waldbusser                                            [Page 27]
  1515.  
  1516. RFC 1514                   Host Resources MIB             September 1993
  1517.  
  1518.  
  1519.    hrSWRunPerfTable OBJECT-TYPE
  1520.        SYNTAX SEQUENCE OF HrSWRunPerfEntry
  1521.        ACCESS not-accessible
  1522.        STATUS mandatory
  1523.        DESCRIPTION
  1524.                "The (conceptual) table of running software
  1525.                performance metrics."
  1526.        ::= { hrSWRunPerf 1 }
  1527.  
  1528.    hrSWRunPerfEntry OBJECT-TYPE
  1529.        SYNTAX HrSWRunPerfEntry
  1530.        ACCESS not-accessible
  1531.        STATUS mandatory
  1532.        DESCRIPTION
  1533.                "A (conceptual) entry containing software
  1534.                performance metrics.  As an example, an instance
  1535.                of the hrSWRunPerfCPU object might be named
  1536.                hrSWRunPerfCPU.1287"
  1537.        INDEX  { hrSWRunIndex }  -- This table augments information in
  1538.                                 -- the hrSWRunTable.
  1539.        ::= { hrSWRunPerfTable 1 }
  1540.  
  1541.    HrSWRunPerfEntry ::= SEQUENCE {
  1542.            hrSWRunPerfCPU          INTEGER,
  1543.            hrSWRunPerfMem          KBytes
  1544.    }
  1545.  
  1546.    hrSWRunPerfCPU OBJECT-TYPE
  1547.        SYNTAX INTEGER
  1548.        ACCESS read-only
  1549.        STATUS mandatory
  1550.        DESCRIPTION
  1551.                "The number of centi-seconds of the total system's
  1552.                CPU resources consumed by this process.  Note that
  1553.                on a multi-processor system, this value may
  1554.                increment by more than one centi-second in one
  1555.                centi-second of real (wall clock) time."
  1556.        ::= { hrSWRunPerfEntry 1 }
  1557.  
  1558.    hrSWRunPerfMem OBJECT-TYPE
  1559.        SYNTAX KBytes
  1560.        ACCESS read-only
  1561.        STATUS mandatory
  1562.        DESCRIPTION
  1563.                "The total amount of real system memory allocated
  1564.                to this process."
  1565.        ::= { hrSWRunPerfEntry 2 }
  1566.  
  1567.  
  1568.  
  1569.  
  1570. Grillo & Waldbusser                                            [Page 28]
  1571.  
  1572. RFC 1514                   Host Resources MIB             September 1993
  1573.  
  1574.  
  1575.    -- The Host Resources Installed Software Group
  1576.    --
  1577.    -- Implementation of this group is optional.
  1578.    --
  1579.    -- The hrSWInstalledTable contains an entry for each piece
  1580.    -- of software installed in long-term storage (e.g. a disk
  1581.    -- drive) locally on this host.  Note that this does not
  1582.    -- include software loadable remotely from a network
  1583.    -- server.
  1584.    --
  1585.    -- This table is useful for identifying and inventorying
  1586.    -- software on a host and for diagnosing incompatibility
  1587.    -- and version mismatch problems between various pieces
  1588.    -- of hardware and software.
  1589.  
  1590.    hrSWInstalledLastChange OBJECT-TYPE
  1591.        SYNTAX TimeTicks
  1592.        ACCESS read-only
  1593.        STATUS mandatory
  1594.        DESCRIPTION
  1595.               "The value of sysUpTime when an entry in the
  1596.               hrSWInstalledTable was last added, renamed, or
  1597.               deleted.  Because this table is likely to contain
  1598.               many entries, polling of this object allows a
  1599.               management station to determine when re-downloading
  1600.               of the table might be useful."
  1601.        ::= { hrSWInstalled 1 }
  1602.  
  1603.    hrSWInstalledLastUpdateTime OBJECT-TYPE
  1604.        SYNTAX TimeTicks
  1605.        ACCESS read-only
  1606.        STATUS mandatory
  1607.        DESCRIPTION
  1608.               "The value of sysUpTime when the hrSWInstalledTable
  1609.               was last completely updated.  Because caching of
  1610.               this data will be a popular implementation
  1611.               strategy, retrieval of this object allows a
  1612.               management station to obtain a guarantee that no
  1613.               data in this table is older than the indicated
  1614.               time."
  1615.        ::= { hrSWInstalled 2 }
  1616.  
  1617.    hrSWInstalledTable OBJECT-TYPE
  1618.        SYNTAX SEQUENCE OF HrSWInstalledEntry
  1619.        ACCESS not-accessible
  1620.        STATUS mandatory
  1621.        DESCRIPTION
  1622.               "The (conceptual) table of software installed on
  1623.  
  1624.  
  1625.  
  1626. Grillo & Waldbusser                                            [Page 29]
  1627.  
  1628. RFC 1514                   Host Resources MIB             September 1993
  1629.  
  1630.  
  1631.               this host."
  1632.        ::= { hrSWInstalled 3 }
  1633.  
  1634.    hrSWInstalledEntry OBJECT-TYPE
  1635.        SYNTAX HrSWInstalledEntry
  1636.        ACCESS not-accessible
  1637.        STATUS mandatory
  1638.        DESCRIPTION
  1639.               "A (conceptual) entry for a piece of software
  1640.               installed on this host.
  1641.  
  1642.               As an example of how objects in this table are
  1643.               named, an instance of the hrSWInstalledName object
  1644.               might be named hrSWInstalledName.96"
  1645.        INDEX { hrSWInstalledIndex }
  1646.        ::= { hrSWInstalledTable 1 }
  1647.  
  1648.    HrSWInstalledEntry ::= SEQUENCE {
  1649.            hrSWInstalledIndex       INTEGER,
  1650.            hrSWInstalledName        InternationalDisplayString,
  1651.            hrSWInstalledID          ProductID,
  1652.            hrSWInstalledType        INTEGER,
  1653.            hrSWInstalledDate        DateAndTime
  1654.    }
  1655.  
  1656.    hrSWInstalledIndex OBJECT-TYPE
  1657.        SYNTAX INTEGER (1..2147483647)
  1658.        ACCESS read-only
  1659.        STATUS mandatory
  1660.        DESCRIPTION
  1661.               "A unique value for each piece of software
  1662.               installed on the host.  This value shall be in the
  1663.               range from 1 to the number of pieces of software
  1664.               installed on the host."
  1665.        ::= { hrSWInstalledEntry 1 }
  1666.  
  1667.    hrSWInstalledName OBJECT-TYPE
  1668.        SYNTAX InternationalDisplayString (SIZE (0..64))
  1669.        ACCESS read-only
  1670.        STATUS mandatory
  1671.        DESCRIPTION
  1672.               "A textual description of this installed piece of
  1673.               software, including the manufacturer, revision, the
  1674.               name by which it is commonly known, and optionally,
  1675.               its serial number."
  1676.        ::= { hrSWInstalledEntry 2 }
  1677.  
  1678.    hrSWInstalledID OBJECT-TYPE
  1679.  
  1680.  
  1681.  
  1682. Grillo & Waldbusser                                            [Page 30]
  1683.  
  1684. RFC 1514                   Host Resources MIB             September 1993
  1685.  
  1686.  
  1687.        SYNTAX ProductID
  1688.        ACCESS read-only
  1689.        STATUS mandatory
  1690.        DESCRIPTION
  1691.               "The product ID of this installed piece of
  1692.               software."
  1693.        ::= { hrSWInstalledEntry 3 }
  1694.  
  1695.    hrSWInstalledType OBJECT-TYPE
  1696.        SYNTAX INTEGER {
  1697.                    unknown(1),
  1698.                    operatingSystem(2),
  1699.                    deviceDriver(3),
  1700.                    application(4)
  1701.               }
  1702.        ACCESS read-only
  1703.        STATUS mandatory
  1704.        DESCRIPTION
  1705.                "The type of this software."
  1706.        ::= { hrSWInstalledEntry 4 }
  1707.  
  1708.    hrSWInstalledDate OBJECT-TYPE
  1709.        SYNTAX DateAndTime
  1710.        ACCESS read-only
  1711.        STATUS mandatory
  1712.        DESCRIPTION
  1713.               "The last-modification date of this application as
  1714.               it would appear in a directory listing."
  1715.        ::= { hrSWInstalledEntry 5 }
  1716.  
  1717.    END
  1718.  
  1719.  
  1720. 5.  References
  1721.  
  1722.    [1]  Rose M., and K. McCloghrie, "Structure and Identification of
  1723.         Management Information for TCP/IP-based internets", STD 16, RFC
  1724.         1155, Performance Systems International, Hughes LAN Systems, May
  1725.         1990.
  1726.  
  1727.    [2]  Rose, M., and K. McCloghrie, Editors, "Concise MIB Definitions",
  1728.         STD 16, RFC 1212, Performance Systems International, Hughes LAN
  1729.         Systems, March 1991.
  1730.  
  1731.    [3]  McCloghrie K., and M. Rose, Editors, "Management Information
  1732.         Base for Network Management of TCP/IP-based internets", STD 17,
  1733.         RFC 1213, Performance Systems International, March 1991.
  1734.  
  1735.  
  1736.  
  1737.  
  1738. Grillo & Waldbusser                                            [Page 31]
  1739.  
  1740. RFC 1514                   Host Resources MIB             September 1993
  1741.  
  1742.  
  1743.    [4]  Case, J., Fedor, M., Schoffstall, M., and J. Davin, "Simple
  1744.         Network Management Protocol", STD 15, RFC 1157, SNMP Research,
  1745.         Performance Systems International, Performance Systems
  1746.         International, MIT Laboratory for Computer Science, May 1990.
  1747.  
  1748.    [5]  Information processing systems - Open Systems Interconnection -
  1749.         Specification of Abstract Syntax Notation One (ASN.1),
  1750.         International Organization for Standardization.  International
  1751.         Standard 8824, (December, 1987).
  1752.  
  1753. 6.  Acknowledgments
  1754.  
  1755.    This document was produced by the Host Resources MIB working group.
  1756.  
  1757.    In addition, the authors gratefully acknowledge the comments of the
  1758.    following individuals:
  1759.  
  1760.               Amatzia Ben-Artzi NetManage
  1761.               Steve Bostock     Novell
  1762.               Stephen Bush      GE Information Systems
  1763.               Jeff Case         SNMP Research
  1764.               Chuck Davin       Bellcore
  1765.               Ray Edgarton      Bell Atlantic
  1766.               Mike Erlinger     Aerospace Corporation
  1767.               Tim Farley        Magee Enterprises
  1768.               Mark Kepke        Hewlett-Packard
  1769.               Bobby Krupczak    Georgia Tech
  1770.               Cheryl Krupczak   Georgia Tech
  1771.               Keith McCloghrie  Hughes Lan Systems
  1772.               Greg Minshall     Novell
  1773.               Dave Perkins      Synoptics
  1774.               Ed Reeder         Objective Systems Integrators
  1775.               Mike Ritter       Apple Computer
  1776.               Marshall Rose     Dover Beach Consulting
  1777.               Jon Saperia       DEC
  1778.               Rodney Thayer     Sable Technology
  1779.               Kaj Tesink        Bellcore
  1780.               Dean Throop       Data General
  1781.  
  1782. 7.  Security Considerations
  1783.  
  1784.    Security issues are not discussed in this memo.
  1785.  
  1786.  
  1787.  
  1788.  
  1789.  
  1790.  
  1791.  
  1792.  
  1793.  
  1794. Grillo & Waldbusser                                            [Page 32]
  1795.  
  1796. RFC 1514                   Host Resources MIB             September 1993
  1797.  
  1798.  
  1799. 8.  Authors' Addresses
  1800.  
  1801.    Pete Grillo
  1802.    10915 NW Lost Park Drive
  1803.    Portland OR 97229
  1804.  
  1805.    Phone: +1 503 526 9766
  1806.    EMail: pl0143@mail.psi.net
  1807.  
  1808.  
  1809.    Steven Waldbusser
  1810.    Carnegie Mellon University
  1811.    4910 Forbes Ave.
  1812.    Pittsburgh, PA 15213
  1813.  
  1814.    Phone: +1 412 268 6628
  1815.    Fax:   +1 412 268 4987
  1816.    EMail: waldbusser@cmu.edu
  1817.  
  1818.  
  1819.  
  1820.  
  1821.  
  1822.  
  1823.  
  1824.  
  1825.  
  1826.  
  1827.  
  1828.  
  1829.  
  1830.  
  1831.  
  1832.  
  1833.  
  1834.  
  1835.  
  1836.  
  1837.  
  1838.  
  1839.  
  1840.  
  1841.  
  1842.  
  1843.  
  1844.  
  1845.  
  1846.  
  1847.  
  1848.  
  1849.  
  1850. Grillo & Waldbusser                                            [Page 33]
  1851.  
  1852.